package com.rolerealm.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.rolerealm.domain.entity.CharacterEntity;
import com.rolerealm.domain.dto.CharacterSearchDTO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 角色数据访问接口
 * 
 * @author RoleRealm Team
 * @version 1.0.0
 */
@Mapper
public interface CharacterMapper extends BaseMapper<CharacterEntity> {

    /**
     * 分页查询角色列表
     * 
     * @param page 分页参数
     * @param searchDTO 搜索条件
     * @return 角色分页列表
     */
    IPage<CharacterEntity> selectCharactersPage(Page<CharacterEntity> page, @Param("search") CharacterSearchDTO searchDTO);

    /**
     * 全文搜索角色
     * 
     * @param page 分页参数
     * @param searchDTO 搜索条件
     * @return 角色分页列表
     */
    IPage<CharacterEntity> searchCharactersPage(Page<CharacterEntity> page, @Param("search") CharacterSearchDTO searchDTO);

    /**
     * 根据ID列表批量查询角色
     * 
     * @param characterIds 角色ID列表
     * @return 角色列表
     */
    List<CharacterEntity> selectByIds(@Param("characterIds") List<Long> characterIds);

    /**
     * 根据分类查询角色数量
     * 
     * @param category 分类
     * @return 角色数量
     */
    Long countByCategory(@Param("category") String category);

    /**
     * 查询热门角色（按交互次数排序）
     * 
     * @param limit 限制数量
     * @return 角色列表
     */
    List<CharacterEntity> selectPopularCharacters(@Param("limit") Integer limit);

    /**
     * 根据技能类型查询角色
     * 
     * @param skillType 技能类型
     * @param limit 限制数量
     * @return 角色列表
     */
    List<CharacterEntity> selectBySkillType(@Param("skillType") String skillType, @Param("limit") Integer limit);
}
